教程:自定义物品

欢迎你来阅读本篇自定义物品教程！物品是MC中非常重要的一个概念，本教程希望从原理开始，通俗易懂地向你展示如何在基岩版添加一个物品。

当然，在阅读本篇教程之前，请确保你已经能够创建一个行为包和资源包，创建一个新物品需要两个包的共同合作。如果你还不清楚，请先浏览Tutorial:制作行为包页面后再来浏览本教程。

如果你是Windows用户，你可以使用Visual Studio Code来编写。这是一个非常强大且实用的IDE，可以大幅简化你的工作流程。

如果你是Android用户，MT管理器也许是个不错的选择。

自定义物品有三个分水岭版本存在：

了解了这些之后，我们就可以按照需求选择版本。本教程将基于1.10和1.20+的版本编写，因为它们是稳定的。当然，1.16.100~1.20-的物品格式编写我们也会简单介绍，向你展示其中的一些重点内容。

Mojang提供了一些原版的实例，这对于我们编写自己的物品有一些帮助。你可以在这里下载到原版的样例包：

首先创建一个行为包和资源包，并写入manifest.json。这是在阅读本教程之前应掌握的基础，这里不多赘述。

物品的行为包部分主要声明这个物品在底层上是如何工作的，例如定义它可以吃，可以种下种子等等属性。因此，如果这个物品不能按照你预期的方式工作，你可以看看是不是行为包出了问题。

在你的行为包中新建一个文件夹items，请注意名字必须完全对应，不要忘记那个s。接下来我们创建一个文件my_custom_item.item.json，写入下面的内容：

这是一个自定义物品所具有的最基本的属性，相当于你给这个物品打了一个地基。我们来简单解释一下这里的内容：

现在我们打完了地基，开始建大楼吧！假设我们希望这个物品只能堆叠至多1个，你可以看下面这段json代码：

这样的话，你的自定义物品将至多堆叠1个。我们现在来解释一下：

旧版本物品的组件数目十分有限，目前仅有以下几个可用：

minecraft:block、minecraft:food、minecraft:foil、minecraft:hand_equipped、minecraft:max_damage、minecraft:max_stack_size、minecraft:seed、minecraft:stacked_by_data、minecraft:use_duration。

旧版本物品最常用的一个例子是食物。事实上1.20+的物品组件因minecraft:food组件不支持施加自定义的状态效果，想要更方便的加入带有状态效果的物品就只能用旧版本物品。下面是一个原版的实例，蜂蜜瓶。请注意这个实例来自原版，所以它的命名空间是minecraft，你的自定义物品是不能把minecraft作为命名空间的！

关于此物品的物品组件解释，请自行在相关的组件页面查阅，这里不予赘述。当然需要指出的一点是，能够读懂原版实例是提升自己能力很重要的一环，请多加训练这样的能力。

物品的资源包主要声明这个物品如何在你的游戏屏幕上呈现，包括它的图标（icon）、动画和文字翻译等。因此如果你的物品不能正常显示，或者文字音效等外显方面出了问题，你可以来排查一下资源包的问题。当然有时候重启游戏或许可以解决问题。这里要指代的内容多而繁杂，希望你可以耐心地读下去。

首先，同理地，在你的资源包中新建一个文件夹items，注意名字必须完全对应。接下来我们创建一个文件my_custom_item.item.json，写入下面的内容：

同样地，我们来解释一下这其中的内容：

在资源包的物品组件中允许以下内容：

minecraft:icon、minecraft:render_offsets、minecraft:use_animation

请自行查阅其中所允许的内容。温馨提醒，如果你定义了你的物品为食物并且想使用喝下食物的音效，请按下文定义：

接下来我们希望让这个物品正确地显示出来。现在请在你的资源包目录下新建一个文件夹textures，并创建一个新文件item_texture.json（注意没有s），写入下面的内容：

前两行你可以不必留意，把它们当作是固定内容。从第三行的texture_data开始，这是物品的短ID与物品贴图所链接的地方。一般格式为

因此还需要将你的物品贴图放到对应位置上。如果你急于没有贴图的话，先从原版实例那里白嫖一个苹果什么的过来，之后，如果你有自己画的需求，推荐使用Blockbench（Windows）、IsoPix（Android）或者专业的画图软件（例如Photoshop）画图。推荐16*16的贴图，但不管怎么说必须是一个正方形的贴图。

到此为止你的物品就应该可以正常显示了，然而如果此时你进入游戏，你的物品名字会变成一段“乱码”：item.test:my_custom_item.name。不要慌张，这是我们还没有定义它的名字。我们需要在资源包的语言文件下指定它的名字。在你的资源包目录下新建一个文件夹texts，并创建两个新文件en_US.lang和zh_CN.lang，分别写入下面的内容：

en_US.lang

zh_CN.lang

这里做个简单解释：

现在你已经写好了你的第一个自定义物品！它将只能堆叠一个，显示出你自定义的贴图。当然，仅凭旧版组件能够实现的内容太少了，因此我们需要更高版本的组件来实现我们想要的功能。

首先请注意，1.20或更高版本很多地方都是与低版本组件的编写大同小异的，因此请确保你已经清楚了1.10~1.16.100格式版本的物品编写方式。我们在这里只是简要提一些大概流程和差异点。

我们同样还是先新建一个文件夹items，创建一个文件my_custom_item_2.item.json。你不必删除你刚刚写入的内容，因为新版的物品是可以和旧版的物品并存的。写入下面的内容：

相信你已经注意到了，在1.20+的物品中，我们把category和minecraft:icon放到了行为包里来写，而在旧版本中这是属于资源包的部分。事实上我们在1.20+中可以把本应在资源包items中的组件一并搬到行为包中，因为Mojang在1.16.100时对这些内容做了整合，并在1.20+的版本开始正式公布。这样可以更加方便地调整物品的组件，改变它的底层行为。

我们在这里先搭好框架，在后面我们来举几个简单的例子帮助你理解。关于1.20+可用的组件，见1.20可用的物品组件。

在高版本中的资源包部分，我们不必再创建items文件夹了，因为这里的内容都放在了行为包里，包括短ID的设置。而item_texture.json和语言文件的设置步骤则是和上面所一致的。但是语言文件上还是有一些细微的差异点，在于翻译键名从item.（物品ID）.name改为了item.（物品ID），少了后面的.name。

将这一部分放到后面来展示，是因为两点:

关于行为包和资源包的相关部分，事实上和1.20的自定义物品编写更加接近，即没有资源包的items文件夹，所有组件整合到行为包中去。

如果你正在使用中国版，很不幸的是如果你需要的话你可能必须要用这个版本区间的物品组件。当然，中国版拥有非常丰富的接口可供你使用，你完全可以通过它们实现意想不到的功能。

制作一把剑在旧版本物品中是难以实现的。然而在1.20+的物品组件中，实现一把剑并不是什么非常困难的事情。我们这里略过资源包，因为这些步骤都是常规的。实现一把剑的几个关键要素如下：

基于此我们可以写出如下内容：

这样就实现了一把可以+9伤害的，耐久值为300的绿宝石剑！

我们知道TNT必须点燃之后才能开始爆炸，但是我们可以直接制作一个放下即炸的TNT！实现它的关键要素如下：

基于此我们可以写出如下内容：

在资源包也搞定之后，可以将物品使用在一个方块上，它将直接像刷怪蛋一样召唤一个TNT！

假如说你希望实现一个手榴弹，且落地即炸，这背后需要的工作量比较大，但是你也需要一个自定义物品，毕竟如果把鸡蛋雪球改了就有污染原版的嫌疑了哦。

基于此我们可以写出如下内容：

当然手榴弹还需要自定义实体的合力发挥才能实现。如果你在这个基础上，将minecraft:projectile中projectile_entity改为minecraft:arrow，你就可以立刻获得简易版飞刀了（当然ID名要记得改）。

本教程为基础教程，不同组件的结合会产生非常有意思的效果，例如自定义盔甲、武器、食物、投掷物等都可以实现。希望对你有所帮助。有关自定义物品的详解请前往基岩版物品文档查看。